FieldQuantities Object

Summary

A collection of physical quantity descriptors (both local and integral) applicable to the current problem result.

Details

In ActiveField, you can obtain a FieldQuantities collection as one of the properties of your problem's Result property. These collections provide you with the lists of local and integral physical quantities related to your problem type in general or specific conditions.

Result object provides two properties of FieldQuantities type:

• The LocalFieldQuantities property accessed with a Point argument represents related to the result's problem type collection of local quantities QuickField can calculate at this point.;
  The LocalFieldQuantities property accessed without arguments represents the collection of all local quantities related to the result's problem type.

• The IntegralFieldQuantities property accessed with a Contour argument represents the collection of related to the result's problem type integral quantities QuickField can calculate integrating over this contour.
  the IntegralFieldQuantities property accessed without arguments represents the collection of all integral quantities related to the result's problem type.

The following FieldQuantities features are common for all ActiveFields collections:

• Count property gives the total number of items in the collection.

• Item method invoked with an integer or a string argument provides access to individual collection items. Any integer argument value should specify the 1-based position of the item in the collection. Any string argument value should specify the name of the required element.

Besides that, the collection FieldQuantities provides methods for adding and removal of its elements:

• The Add method called with quantity parameter of the QfQuantity type, adds the physical property to the collection.
  If a value with the same identifier is already present in the collection – nothing happens.
• The Remove method, called with quantity parameter of the QfQuantity type, removes the physical property from the collection.
• The Clear method (without parameters) removes all collection elements.

In the example below removal and adding methods are used to make a collection having two physical units: potential and its gradient absolute value:

Dim coll as QuickField.FieldQuantities
set coll = res.LocalFieldQuantities
coll.Clear
coll.Add (qfPotential)
coll.Add (qfGrad)

You can obtain the name of a FieldQuantity object through the value of its Name property.